home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / insfix.zip / README.TXT < prev   
Text File  |  1992-03-27  |  15KB  |  316 lines

  1.  
  2.                           ---->  INSFIX V1.4  <----
  3.  
  4.                                March 27, 1992
  5.  
  6. (C) 1992 ZyBel MicroSystems Inc.  All rights reserved.
  7.  
  8.  
  9. 1.  Introduction
  10. ----------------
  11.  
  12. This file describes a LAN utility called INSFIX, which was created to solve a
  13. specific problem with a commercial program known as INSMARK*, but which has
  14. many uses in a networked environment.
  15.  
  16. INSMARK, a popular insurance application, is available in a network ready
  17. version, but only supporting the Novell NOS.  INSMARK is not compatible with
  18. other networks, including LANTASTIC.  ZyBel was able to get INSMARK to
  19. operate perfectly on a LANTASTIC network by writing the INSFIX utility.
  20.  
  21. Insfix is similar in nature to the DOS APPEND command, but with some
  22. important differences:
  23.  
  24. 1).  INSFIX only occupies 2.4K of memory (as opposed to 10K of memory with
  25.      APPEND if executables are to be included).
  26.  
  27. 2).  INSFIX is removable from memory. APPEND is not.
  28.  
  29. 3).  INSFIX will not redirect FCB calls (APPEND does).  However, programmers
  30.      were discouraged from using DOS FCB file functions after DOS V2.0, and
  31.      thus very few commercial applications do so today.
  32.  
  33. 4).  INSFIX supports two special options that modify the file open access
  34.      modes and/or the share permissions for redirected files.  These options
  35.      can be used to allow a single user application to be converted to multi-
  36.      user LAN operation - depending upon the structure of the application.
  37.  
  38. NOTE:     ZyBel does NOT support in any way the violation of commercial
  39.           single user software licenses, and the license granted with INSFIX
  40.           specifically prohibits its use in this fashion.  INSFIX can be used
  41.           to permit some types of in-house developed applications to run in a
  42.           multi-user environment, and can be used to correct application
  43.           specific problems with some network-ready (multi-user licensed)
  44.           commercial programs.
  45.  
  46.  
  47. A demonstration version of INSFIX is included along with this text file.
  48. This demonstration version is fully functional, but will cease operating
  49. after approximately 200 file redirections.  The symptoms of the DEMO program
  50. stopping operation will be a failure in the application currently running, or
  51. the inability to start a new application which requires INSFIX.  The program
  52. can be removed from memory, and re-loaded as required, for evaluation
  53. purposes.  The demonstration version is called INSDEMO.EXE, and should be
  54. used in place of INSFIX in the application examples discussed in this file.
  55.  
  56.  
  57. 2.  Insmark
  58. -----------
  59.  
  60. As mentioned in the introduction, Insmark is a popular program for the
  61. insurance industry providing comprehensive graphics capabilities for
  62. producing insurance illustrations and analysis.
  63.  
  64. Insmark is available in a network ready version, but only for use with the
  65. Novell NOS.  The multi user version of Insmark is essentially identical to
  66. the single user version - only the installation instructions differ.  Insmark
  67. is loaded in a "shared" directory (one that all users have access to through
  68. the network), and a subset of the files are copied to a private directory
  69. (each user has a private directory).
  70.  
  71. The Novell MAP command is then used to establish a search path to the shared
  72. directory.  Insmark is actually run from the private directory.  When Insmark
  73. is first started, it requests that the user enter the name of the directory
  74. where Insmark is located.  The user should specify the PRIVATE directory
  75. path.  Insmark will then try to access files in the private directory.  If
  76. the file is a personal data file, it is opened in the private directory.  If
  77. the file is a shared file (program file, overlay etc), it is opened in the
  78. shared directory because of the Novell MAP command.  This is essentially
  79. identical to the DOS APPEND command if the executable option is specified
  80. (/X:on).
  81.  
  82. Through the above process, Insmark keeps multiple copies of personal files
  83. (each in a private directory), and reads files from a shared data directory.
  84.  
  85. When trying to configure Insmark on a Lantastic network, the DOS APPEND
  86. command was used in place of the Novell MAP command.  Unfortunately, the DOS
  87. APPEND command does not function with Insmark.  In reality, even if Append
  88. did operate with Insmark, the application would still not operate on a
  89. network.  This is because Insmark opens shared data files in R/W mode, even
  90. if it is only reading information from the file.  As a result, the shared
  91. files cannot be set to Read Only mode, and share violations will occur if
  92. more than one user attempts to read from the same file at the same time.
  93.  
  94.  
  95. 3.   INSFIX
  96. -----------
  97.  
  98. The INSFIX utility solves these problems by providing a functional version of
  99. APPEND, but with several special options:
  100.  
  101. a).  The /X option allows executable calls (load a program) to be redirected
  102.      along with data read/write functions.  This is similar to the APPEND
  103.      /X:ON parameter.
  104.  
  105. b).  The /S option will modify file OPEN share parameters on REDIRECTED FILE
  106.      OPERATIONS to DENY/NONE.  This means that if a file was not found in the
  107.      specified directory, but is found in a redirected path, the share
  108.      permissions will be changed to DENY/NONE, preventing any share
  109.      violations from occurring.
  110.  
  111. c).  The /R option will modify any file OPEN requests on REDIRECTED FILE
  112.      OPERATIONS to READ mode.  Since the purpose of INSFIX is to allow shared
  113.      files to be accessed transparently to a DOS application, presumably the
  114.      application will only read data from these files (else file corruption
  115.      could occur). As a result, applications should only open such files in
  116.      READ mode.  Insmark, as an example, still opens these files in R/W mode.
  117.      This option modifies the actual file open command to specify READ mode,
  118.      thus allowing the shared files to be configured as READ/ONLY (using the
  119.      DOS ATTRIB command), and preventing any share violations.
  120.  
  121. Either of options b) or c) above can be used to prevent share violations in a
  122. networked environment.
  123.  
  124.  
  125. The correct syntax for INSFIX is as follows:
  126.  
  127. INSFIX    PATH1 <PATH2>  ... <PATH10> </X> </R> </S> </U>
  128.  
  129. where     PATH1          is a DOS path name to which file operations should
  130.                          be redirected if such operations failed in the
  131.                          current directory, or in the specified full path.
  132.           
  133.           PATH2          is a second DOS path name for redirection (if the
  134.                          file operation was not successful in PATH1).
  135.           ...
  136.  
  137.           PATH10         up to 10 PATHs may be specified
  138.  
  139.           /X             Specifies that executable file operations should be
  140.                          redirected along with file open/read/write requests.
  141.                          This allows programs to be run from appended paths,
  142.                          or overlays loaded.
  143.  
  144.           /R             Specifies that redirected file OPEN functions (file
  145.                          operations that failed in the current directory or
  146.                          the specified full path) should have the access mode
  147.                          changed to READ.
  148.  
  149.           /S             Specifies that redirected file OPEN functions (file
  150.                          operations that failed in the current directory or
  151.                          the specified full path) should have the share
  152.                          permissions changed to DENY/NONE.
  153.  
  154.           /U             Will unload INSFIX from memory if possible (if no
  155.                          other TSR programs were loaded after INSFIX that use
  156.                          the same interrupts).
  157.  
  158.  
  159. If INSFIX is run without any arguments, the current INSFIX settings are
  160. displayed.  INSFIX may be run at any time to replace the parameters currently
  161. loaded in memory.  This will not load a second copy of INSFIX, but will
  162. rather cause the parameters in the memory resident program to be changed (the
  163. new parameters, including options, will replace those previously loaded).
  164.  
  165. NOTE:     Although INSFIX can run in high memory through the use of the DOS
  166.           5.0 LOADHIGH command, this practice is not recommended. The
  167.           technique which INSFIX uses to located a previously loaded version
  168.           (and communicate new parameters) is not compatible with high
  169.           memory, and thus a copy of INSFIX loaded in high memory cannot be
  170.           removed without rebooting.  However, INSFIX only occupies 2.4K of
  171.           memory, so this is generally not a problem.
  172.  
  173.  
  174. 4.   How INSFIX Works
  175. ---------------------
  176.  
  177. To help in understanding the use of INSFIX, some discussion of internal
  178. operation will be provided.
  179.  
  180. When a DOS file OPEN or FIND FIRST command (functions 3D and 4E) or a
  181. LOAD/EXECUTE command (function 4B, if the /X option is specified) is called
  182. by an application program, INSFIX intercepts the DOS call.  INSFIX will then
  183. attempt the DOS call exactly as specified by the application.  If the return
  184. code indicates successful completion, control is returned to the DOS
  185. application (i.e. INSFIX will have no effect).
  186.  
  187. If, however, the return from the DOS call indicates the file operation
  188. failed, INSFIX will parse the specified path name to isolate the file name
  189. and file extension.  It will then append the file name on to the INSFIX paths
  190. (PATH1 through PATH10), and attempt the same file operation with each new
  191. path.  This process is repeated until all INSFIX paths have been tried, or a
  192. successful file operation results.  If any of these calls are successful,
  193. control is returned to the DOS application.  If all INSFIX paths fail, the
  194. application will receive the DOS failure code.
  195.  
  196. INSFIX uses it's search paths in the order specified; that is PATH1 is tried
  197. first, followed by PATH2 etc.
  198.  
  199. The operation of the INSFIX /R and /S command switches will only affect
  200. redirected file operations - that is file functions which use the INSFIX
  201. paths.  If the path specified by the application was successful, the /R and
  202. /S options will have no effect.
  203.  
  204. INSFIX paths may be specified with an optional drive letter (e.g.
  205. D:\INSMARK), or without the drive letter, in which case the current drive
  206. will be used for appended directories.
  207.  
  208.  
  209. 5.   An Example
  210. ---------------
  211.  
  212. The INSMARK application is tailored for each insurance carrier by utilizing a
  213. custom batch file.  A data file from the particular insurance carrier's
  214. software is copied to the Insmark private directory (the data file is called
  215. BUTTON), and then INSMARK is started.  To configure this system, the
  216. following INSFIX command would be utilized at each workstation:
  217.  
  218.      INSFIX H:\INSMARK /S /X
  219.  
  220.      Where H:\INSMARK is the location of the shared INSMARK files.
  221.  
  222. Assuming a filed called "LOCAL" was located in the current directory
  223. (C:\PRIVATE), and a filed called "SHARED" was located in the common INSMARK
  224. directory (H:\INSMARK), the following file open commands would actually
  225. result in different files being opened:
  226.  
  227.      OPEN PATH REQUEST        ACTUAL FILE OPENED
  228.      -----------------        ------------------
  229.      C:\PRIVATE\LOCAL         C:\PRIVATE\LOCAL
  230.      LOCAL                    C:\PRIVATE\LOCAL
  231.      C:\LOCAL                 <not found>
  232.      C:\PRIVATE\SHARED        H:\INSMARK\SHARED
  233.      SHARED                   H:\INSMARK\SHARED
  234.      C:\SHARED                H:\INSMARK\SHARED
  235.  
  236. In the above example, an open command for the "SHARED" file would have the
  237. share permissions changed to DENY/NONE (because of the /S switch), preventing
  238. any share violations in a multi-user environment.
  239.  
  240. Because the /X switch was provided, any programs not found in the current
  241. directory can be loaded from the specified shared directories (without
  242. requiring the DOS PATH statement to be modified).  In addition, the /X option
  243. will attempt to load executable files from the shared directory even if the
  244. DOS command specified a full path.  For example, if the user typed "C:\BMENU"
  245. (to run a program called BMENU.EXE) which was not found in the C:\ directory,
  246. and a copy did exist in the H:\INSMARK directory, that copy would be loaded.
  247. This behaves differently from the DOS PATH command.
  248.  
  249.  
  250. 6.   Using INSFIX with Single User Applications
  251. ----------------------------------------------
  252.  
  253. INSFIX can be used to make some types of in-house developed single-user
  254. applications operate in a multi-user environment, with limitations.
  255.  
  256. If the application has a number of files from which it only reads data
  257. (including program files and overlays), and only has a few files that it
  258. writes to, this program can be made to operate multi-user, with a private
  259. copy of the "write" data for each user (the application cannot share output
  260. files unless it is specifically written for a network).
  261.  
  262. To configure the above application, all common "read only" files and programs
  263. should be located in a shared directory (lets say H:\SHARED).  All files
  264. which are written by the application should be copied to local private
  265. directories (for example, C:\PRIVATE).
  266.  
  267. On each workstation, the user would install INSFIX, with H:\SHARED specified
  268. as the redirected path.  To prevent share violations, the /R option can be
  269. utilized (in which case all shared files must be made READ/ONLY using the DOS
  270. ATTRIB command), or the /S option should be used.
  271.  
  272. The following INSFIX command could be used:
  273.  
  274.      INSFIX H:\SHARED /R /X
  275.  
  276.  
  277. Although the DOS Append command can also be used in some cases to perform the
  278. same function, INSFIX is smaller than Append (2.4K verses 10K), can be
  279. removed from memory when finished, and has the optional share arguments to
  280. ensure that sharing violations do not result.
  281.  
  282.  
  283. 7.   Ordering INSFIX
  284. --------------------
  285.  
  286. A fully operational copy of INSFIX is obtainable directly from ZyBel for a
  287. cost of $99 per network.  ZyBel accepts VISA, Mastercard, American Express,
  288. or COD company check.
  289.  
  290. Please address all inquiries to:
  291.  
  292.      ZyBel MicroSystems Inc.
  293.      ATTN: Warren Belkin
  294.      PO Box 1284
  295.      Weston, CT  06883-0284
  296.  
  297.      203-226-8800
  298.      203-226-8851 (FAX)
  299.  
  300.      Compuserve ID: 70571, 3651
  301.  
  302.  
  303. 8.   ZyBel MicroSystems Inc.
  304. ----------------------------
  305.  
  306. ZyBel MicroSystems Inc. is a software developer and Authorized Artisoft
  307. reseller specializing in LANs, custom Voice Response applications, and Wide
  308. Area Networking products (T1, LAN Bridging etc).
  309.  
  310. ZyBel maintains offices in Fairfield County, CT and Herndon, VA, and has a
  311. technical support center located in Dallas, TX.
  312.  
  313.  
  314. *    All products of other companies mentioned in this file are trademarks of
  315.      their respective manufacturers.
  316.